home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 7 / BBS in a Box - Macintosh - Volume VII (BBS in a Box) (January 1993).iso / Files / Game / S / StarChart.cpt / StarChart.txt < prev   
Text File  |  1987-01-11  |  7KB  |  159 lines
  1. StarChart version 2.0 by Tim Wentworth, January 10, 1987.
  2. _________________
  3.  
  4. StarChart is a standalone program that will plot a portion of the night
  5. sky on the Macintosh screen.  Several new features have been added to
  6. this version of StarChart.  Here is how to use the program:
  7.  
  8. 1. StarChart will plot a section of the sky based upon information given
  9. to it by the user.  Under the StarChart menu, you will see four menu
  10. options.  The first is Plot New Chart....  After choosing this command,
  11. you will see a dialog box where you can enter three numbers, View Angle,
  12. Right Ascension and Declination.  If you don't know what these terms
  13. mean, the picture may help you.  Note that the View Angle must be between
  14. 1 and 360, Right Ascension must be between 0 and 24, and Declination must
  15. be between -90 and 90.  Click the mouse on Plot to begin plotting that
  16. portion of the sky.
  17.  
  18. 2. The next menu choice under the StarChart menu will bring up a list of
  19. the 88 constellations.  StarChart will plot the section of the sky that
  20. contains the constellation that you choose.
  21.  
  22. 3. The next menu choice will list Messier objects.  StarChart will plot
  23. the section of the sky that contains that Messier object.  The object
  24. will be plotted at or near the center of the screen.
  25.  
  26. 4. The next menu choice will list popular star names for 88 of the
  27. brightest stars in the sky.  As above, after choosing one of these,
  28. StarChart will plot that portion of the night sky.  The star chosen
  29. will be plotted at or near the center of the screen.
  30.  
  31. 5. StarChart will take from a few seconds to several minutes to plot
  32. the sky.  The plotting time depends on the coordinates given.
  33. Generally, the farther away from 0 the declination gets, the longer
  34. the plotting time.  Also, larger view angles will increase the plotting
  35. time.  Just click the mouse if you wish to cancel the plot at any time.
  36.  
  37. 6. After StarChart has finished plotting, you may retrieve data about
  38. any object on the screen by pointing to it with the mouse and clicking.
  39. A menu will appear in the menu bar that contains information on that
  40. object.  If the star does not have a popular name, the title of the
  41. menu will be its abbreviated Greek designation.  For example, the star
  42. "Beta Scorpio" would be abbreviated "BETSCO".  The Greek letter usually
  43. represents the rank in brightness in that constellation.  For example,
  44. "Beta Scorpio" would probably be the second brightest star in the
  45. constellation Scorpio (but this is not always true).  If the star does
  46. have a popular name, that name will be the title of the menu, and its
  47. Greek designation will be the first entry under the menu bar.  Below
  48. this information is the Right Ascension, Declination, Magnitude and
  49. Color Index of the star.  The magnitude will range any where from -.1
  50. to 9.9, the larger the number, the less bright the object.  (A few
  51. Messier objects had magnitudes above 9.9.  These were entered in the
  52. database as "9.9".)  The Color Index is an indicator of the color of
  53. the star.  It ranges from -.25 to +2.5.  A lower number means the star
  54. is bluer; a higher number means the star is redder.  Note that Messier
  55. objects do not have a Color Index.
  56.  
  57. 7. Under the "Draw" menu is the option "Draw Grid".  Choosing this
  58. option will draw a labeled grid across the screen, with lines
  59. representing hours of Right Ascension and 10 degrees incriments in
  60. declination. This facilitates star-hopping with a telescope.
  61.  
  62. 8. By holding down the command key, you may draw straight lines across
  63. the screen.  This is useful for outlining constellations or other
  64. objects.  The lines that you draw may be erased with the "Erase Lines"
  65. option in the "Draw" menu.
  66.  
  67. 9. The third option under the "Draw" menu allows you to invert the screen
  68. so that the stars appear black on a white screen.  This is useful in
  69. case you want to print the contents of the screen using the Command-
  70. Shift-4 key combination.
  71.  
  72. 10. The "Brightness" menu allows you to selectively plot certain
  73. magnitudes of stars.  All magnitudes of stars will be plotted if "Plot
  74. All Stars" is chosen.  If you wish to see only stars between magnitudes
  75. 2.0 and 2.9, choose that option.  Note that you can choose any
  76. combination of magnitudes; for example you can choose to see only stars
  77. brighter than 1.0 and dimmer than 5.0.  Choosing "Plot All Stars" cancels
  78. all options previously selected.  Note that limiting the stars that
  79. StarChart has to plot speeds up the plotting greatly.
  80. _______________________
  81.  
  82. Modifying StarChart
  83.  
  84. You may modify StarChart if you are familiar with a few Macintosh
  85. utilities such as ResEdit and FEdit.
  86.  
  87. 1.  The StarChart database is contained in the data fork of the program.
  88. This may be accessed using a program such as FEdit and opening the
  89. data fork.
  90.  
  91. 2.  The data is ordered by right ascension, from 0 to 24 hours.  The
  92. format of the data is:
  93.  
  94. ALPLEO 10084+1158+1.4 -0.11 178
  95.  
  96. starname (6 characters)
  97. space
  98. right ascension (5 digits)
  99. declination (4 digits plus sign)
  100. magnitude (floating point number plus sign)
  101. space
  102. color index (floating point number plus sign)
  103. space
  104. popular star name index (3 digits)
  105.  
  106. 3. If you are unhappy about the coordinates of any object, you may use
  107. FEdit to change those numbers.  Likewise with the magnitude or the
  108. color index of a particular object.
  109.  
  110. 4. When you choose to plot a constellation, Messier object or star by
  111. popular star name, StarChart looks up the coordinates of that object
  112. in a STR# resource.
  113.  
  114. STR# 128  Constellations
  115. STR# 129  Popular Stars
  116. STR# 130  Messier Objects
  117.  
  118. Following each name is the view angle, right ascension and declination
  119. in integers that StarChart uses to plot the general area of the sky 
  120. that contains that object.  Using a program such as ResEdit, you may
  121. change or fine tune any of these numbers to your liking.
  122.  
  123. 5. 233 of the stars in the database have popular star names.  This name
  124. will appear in the menu bar whenever you click on that star with the
  125. mouse.  The list of popular star names is not exhaustive; there are
  126. probably others that have not been included.  It is possible to add
  127. a popular name to a star this way:
  128.  
  129. First, the last three digit number in the data base for any particular
  130. star is its popular star name index.  See above: the index number for
  131. Alpha Leo is 178.  This means that the popular star name for Alpha Leo
  132. is the 178th string in STR# resource 131.  If a star does not have a
  133. popular star name, the index number is 000.  By changing this number
  134. (using FEdit) and adding another string to STR# 131 (using ResEdit)
  135. you can add your own popular star names.  Warning: the first index
  136. number you should use should be 234, since 1 through 233 have already 
  137. been used.
  138.  
  139. Since many stars have different popular star names (depending on the
  140. culture that originated the name) you may also wish to simply change
  141. the popular star name already contained in STR# 131.
  142.  
  143. ________________
  144.  
  145. StarChart may have trouble when used on a 128k Macintosh.  The program 
  146. may crash when used under these conditions.  Please make a backup
  147. first before running the program so you won't have to re-download.
  148.  
  149. _________________
  150.  
  151. StarChart 2.0 is public domain, is not copyrighted, and may be used and
  152. passed on freely.  I would be interested to hear any comments you 
  153. have on StarChart 2.0.  You may leave mail for me on:
  154.  
  155. CompuServe  74146,2362
  156. Genie       WENTWORTH
  157.  
  158. Enjoy the program.  Tim Wentworth.
  159.